home *** CD-ROM | disk | FTP | other *** search
/ 17 Bit Software 3: The Continuation / 17-Bit_The_Continuation_Disc.iso / amigan / amigan 4 / arc016 / arc016.doc < prev    next >
Encoding:
Text File  |  1994-01-27  |  5.8 KB  |  156 lines
  1. AmigArc - Archive utility, Version 0.16, created on 07/17/86 at 19:01
  2.  
  3. Compatible with ARC v5.0
  4.  
  5. (C) COPYRIGHT 1986 by Raymond S. Brand; ALL RIGHTS RESERVED
  6. (C) COPYRIGHT 1985,86 by System Enhancement Associates; ALL RIGHTS RESERVED
  7.  
  8. Please refer all inquiries to:
  9.  
  10.        Raymond S. Brand
  11.        c/o The Lido Hotel (a Fido BBS, node 16/630)
  12.        (203) 248-7324
  13.        or AMuse (a Fido BBS, node 107/134)
  14.        (212) 269-4879
  15.  
  16.  
  17. Hello,
  18.    AmigArc v0.16 is a version of ARC v5.0 ported to the Amiga. As such, it
  19. can perform all of the normal ARC commands on '.ARC' files (for information
  20. on ARC commands, find a copy of ARC.DOC).
  21.  
  22. Changes for version 0.16:
  23.    1) No noteworthy (none were reported!) bugs were fixed in this release
  24.       and some of the code was cleaned up, and error reports now go to
  25.       stderr instead of stdout.
  26.    2) The "time-out" has been removed.
  27.  
  28. Known bugs remaining:
  29.    1) There is a bug (at least one) in the RAM: disk handler in AmigaDos so
  30.       please do NOT operate on ".ARC" files resident on the RAM: disk.
  31.    2) Searches of directories with many entries is very time consuming. I am
  32.       told that the 1.2 release of AmigaDos will have some form of buffering
  33.       mechanism to fix this.
  34.    3) The NOT operator for wild card matching does not always work. The fix
  35.       looks to be a major rewrite of the WCmatch routines (sigh...).
  36.    4) Files are still not 'dated' correctly when extracted due to an
  37.       AmigaDos shortcoming.
  38.  
  39. Items of Note:
  40.    1) The Run command will NOT be supported.
  41.  
  42.    2) The current version uses the MS DOS '.ARC' file structure. This means
  43.       that file names should follow MS DOS conventions. The next version will
  44.       be able to use the full AmigaDos filenames, and will have an MS DOS
  45.       compatibility option.
  46.  
  47.    3) Wild Cards are permitted in the filename portion of the template, but
  48.       NOT in the path. The Wild Card scheme used is:
  49.  
  50. /*
  51.  * WCmatch: Function to determine if the first string matches
  52.  *    the template in the second string. If the third parameter
  53.  *    is zero then case does NOT matter.
  54.  *
  55.  *    Returns:
  56.  *       1 if string matches template.
  57.  *       0 if string does NOT match template.
  58.  *       Any other value indicates a template syntax error.
  59.  *
  60.  *    19860308 Raymond S. Brand
  61.  *
  62.  *    Version 0.08
  63.  *
  64.  *    The following describes the syntax of a valid template.
  65.  *       Items in braces ('{' and '}') may be repeated zero or more times.
  66.  *
  67.  * <template>  := <AGroup>
  68.  *
  69.  * <AGroup>    := <PGroup>{&<PGroup>}  'AND'
  70.  *
  71.  * <PGroup>    := <LGroup>{|<LGroup>}  'OR'
  72.  *
  73.  * <Group>     := <LGroup>{|<LGroup>}  'or'
  74.  *
  75.  * <LGroup>    := <SGroup>{<SGroup>}   'Match-String'
  76.  *
  77.  * <SGroup>    := (<Group>)            'grouping'
  78.  *             := %                    'End-of-Name'
  79.  *             := ^<SGroup>            'NOT'
  80.  *             := <Literal1>
  81.  *             := ?                    'Any-Character'
  82.  *             := #<SGroup><MGroup>    'Zero-or-More Followed-By'
  83.  *             := *<MGroup>            'Zero-or-More-of-Any-Character'
  84.  *             := [<EnumList>]         'Enumeration-List'
  85.  *
  86.  * <MGroup>    := <LGroup>
  87.  *             :=
  88.  *
  89.  * <EnumList>  := <EnumPart>{,<EnumPart>}
  90.  *
  91.  * <EnumPart>  := <Literal2>
  92.  *             := <Literal2>-<Literal2>   'All-Characters-From To'
  93.  *
  94.  * <Literal1>  := <any printing character except:
  95.  *                   '#', '%', '^', '&', '*', '(', ')', '|', '\', '[',
  96.  *                   ']' and '?'>
  97.  *             := \<any printing character including the above>
  98.  *
  99.  * <Literal2>  := <any printing character except:
  100.  *                   '\', '[', ']', '-' and ','>
  101.  *             := \<any printing character including the above>
  102.  *
  103.  *
  104.  *    NOTES:
  105.  *       The 'AND' and the 'OR' functions have an implicit 'End-of-Name'
  106.  *          function before their respective operators.
  107.  *       The 'or' function moves the internal name pointer just past the
  108.  *          first match that it finds.
  109.  *       The second form of <EnumPart> matches the current name character
  110.  *          if the first literal is less than or equal to the current name
  111.  *          character, and the current name character is less than or equal
  112.  *          to the second literal. Or if the first literal is less than the
  113.  *          current name character, or the current name character is less
  114.  *          than the second literal when the first literal is greater than
  115.  *          the second literal. An <EnumPart> will never match the name
  116.  *          terminator. e.g. 'a-f' will match 'a', 'b', 'c', 'd', 'e' and
  117.  *          'f'; Whereas, 'f-a' will match all characters except 'a', 'b',
  118.  *          'c', 'd', 'e' and 'f'.
  119.  *       The '*' operator is equivalent to '#?'.
  120.  */
  121.  
  122.    4) This is a beta test version, please keep backups of all important
  123.       files. If you experience a problem or bug in the program, please send
  124.       me a message describing what you were doing and what happened (be
  125.       specific) at:
  126.  
  127.          The Lido Hotel (a Fido BBS)
  128.          (203) 248-7324 (Ct.)
  129.             (where I try to 'check in' everyday)
  130.  
  131.          Amuse (a Fido BBS)
  132.          (212) 269-4879 (NYC)
  133.             (where I will try to login at least once a week)
  134.  
  135.    5) Do NOT bother System Enhancement Associates about this program. They
  136.       have little to do with the Amiga version of ARC.
  137.  
  138.    6) Real documentation will become available at the release of the
  139.       production version of AmigArc.
  140.  
  141.    7) Suggestions, comments, criticisms, etc. are welcome and encouraged.
  142.  
  143.    8) This version of AmigArc does not have a "timeout" but please try to
  144.       always use the latest version available.
  145.  
  146.    9) For the latest version of AmigArc check the Lido Hotel or Amuse.
  147.  
  148.   10) To speed compression, ASSIGN ARCTEMP: RAM:
  149.  
  150.   11) The correct file size for AmigArc.015 is 63032 bytes.
  151.  
  152.  
  153.  
  154.                                  Raymond S. Brand
  155.                                       RSBX
  156.